Objectives

• What is Git & GitHub?
• Install Git; Create GitHub profile.
• Learn to create & maintain lecture notes on GitHub.
• Learn about README files & MarkDown syntax.
• Use Github Pages to publish our files on a website.

Git vs GitHub

What’s Git?
Git is a distributed, version-control-system (VCS) for tracking changes in source code.
It was created by Linus Torvalds (= creator of Linux) to manage the Linux Kernel source code.

• Checkout this video if you want to learn the differences between Centralized & Distributed VCS.

What’s Github?
GitHub allows you to host your content (probably source code) on the internet, allowing you to manage it using Git.

So, Git is the tool that allows you to manage several versions of a software;
GitHub gives you a website where you can post your work online, and manage it using Git.

What’s in it for you?
>> Answer
>> Source Code

Git Installation *

• Install Git. Also, install Git-LFS.
  * When working from Shell, make sure to Run As Administator.

GitHub: SignUp

GitHub: Create A New “Repository”

GitHub: Upload Files (Manual)

GitHub: Upload Files (Auto)

README.md files

Markdown & HTML

We’ll learn markdown syntax while looking at our output side by side.

• It’s common to see HTML code inside markdown files.
• To include multimedia (images, audio & video), I prefer using HTML because it’s easier to control them this way. So, before learning markdown’s syntax, let’s learn HTML’s multimedia tags.

HTML: Multimedia Tags

<img> <audio></audio> <video></video>

<img   src="path/to/file.png"
       width="640"
       height="360"
       title="Title"
       alt="No Image">

<audio src="path/to/file.mp3"
       controls preload>
</audio>

<video src="path/to/file.mp4"
       width="640"
       height="360"
       controls preload>
</video>

MarkDown: Create Lecture Notes

We will write our content in a README.md file.
Insert all files, images, … as links within this file.

[README.md (code)] [README.md (output)]

GitHub Pages ^*

[README.md (output)] [Webpage]

• What’s Github Pages?
  GitHub Pages lets you turn your GitHub repositories into websites.
  
  
  

Practice

Using what we’ve learnt so for, create a Test project.
[Start]

Later On
For reference, [README.md] & [Final Webpage]

Repository: RESET (Soft/Hard)

What are Soft & Hard Resets?

A Soft Reset resets your local copy of the project to a previous version.
A Hard Reset resets your online copy of the project to a previous version (after executing git push).

• Example

git reset --soft 0ad5a7a6
git reset --hard 0ad5a7a6

When to use Soft & Hard Resets?

A Soft Reset is useful when you want to build on top of a previous version, starting from the current version. You do not delete any previous versions.
A Hard Reset is useful when you want to delete all modifications beyond a certain version, and want to build on from this version only.

Repository: DELETE

References

[1] “Getting Started with GitHub”
[2] “Git Large File Storage”
[3] “Git & GitHub Crash Course” by Brad Traversy

Cheatsheets

• Git
• MarkDown